=========================================================================
ISTRUZIONI 
========================================================================

Il tar file del secondo frammento comprende i seguenti file

$$ tar tvf lsokit_f2CARS.tar

CARS/src/README-2
CARS/src/Makefile
CARS/src/Makefile/testcarstat
CARS/src/DATA/carstat.input1
CARS/src/DATA/carstat.input2
CARS/src/DATA/out.carstat.check





-----------------------------------------------
Descrizione dei file contenuti nel kit
-----------------------------------------------

README-2		: questo file

Makefile		: makefile per il test finale dei primi 2 frammenti e la
			  consegna  
			  (NON MODIFICARE se non nelle parti richieste)

testcarstst		  : script che effettua il test

DATA/carstat.input? :     file di dati ed output atteso per il test
DATA/out.carstat.check 
			   (NON MODIFICARE)


------------------------------------------------
Cosa deve essere realizzato
------------------------------------------------

Il secondo frammento prevede la realizzazione di uno script bash (carstat) 
che elabora off-line i file di log generati da mgcars ed elabora varie
statistiche. Le specifiche del comportamento dello script si trovano
nella Sezione~6 del progetto cars1011.pdf. 


----------------------------------------------------------------------------
Apertura, chiusura e lettura di file in BASH
----------------------------------------------------------------------------
L'apertura e la chiusura di un file puo' essere effettuata in bash attreverso
la 'exec' in particolare:

   exec n< file_name    

apre il file file_name in lettura e gli assegna il file descriptor 'n' 

   exec n> file_name

apre il file file_name in scrittura (file descriptor n)

   exec n<> file_name

apre in lettura e scrittura. Invece per chiudere il file descriptor n

   exec n>&-

Dopo aver aperto il file \`e possibile leggerlo utilizzando il comando 'read'
con opzione -u numero_descrittore.

------------------
Come procedere :
-----------------

0) leggere attentamente questo README 

1) analizzare accuratamente i file di input (carstat.input?) e
   l'ouput atteso (out.carstat.check) 

2) implementare lo script richiesto, con le opportune sottofunzioni in un file
   './carstat' nella directory CARS/src
   testando incrementalmente il codice prodotto

3) testare infine lo script con 

       bash:~$ make test21

  NOTA: (1) tutti i file sviluppati per la soluzione si devono trovare nella
  directory CARS/src
  (2) E' importante che il test venga effettuato solo su uno script 
  gia' ragionevolmente corretto  altrimenti i risultati possono essere di
  difficile interpretazione, fuorvianti o inutili.

4) preparare la documentazione: ovvero commentare adeguatamente il file che
   contiene la soluzione aggiungendo la dichiarazione di originalita'

   # file: mailscript
   #    \author Nino Bixio
   #  Si dichiara che il contenuto di questo file e' in ogni sua parte opera
   #  originale dell' autore.  

5) aggiornare il file "gruppo.txt" (quello del primo frammento) con nome e dati

6) consegnare il file ESCLUSIVAMENTE eseguendo

      bash:~$ make consegna2

   e seguendo le istruzioni. Questo target crea un file tar che deve
   essere inviato come allegato a susanna@di.unipi.it con subject
   "lso11: consegna secondo frammento".

   Tutte le consegne verranno confermate con un messaggio di reply
   all'indirizzo da cui e' stato inviato il tar entro 2/3
   giorni. In caso questo non si verifichi contattare il docente.
   
---------------------------------------
 NOTE IMPORTANTI: LEGGERE ATTENTAMENTE
---------------------------------------

1) gli eleborati non contenenti un tar creato da
   "make consegna2" non verranno accettati

2) tutti gli elaborati verranno confrontati fra di loro con tool automatici
   per stabilire eventali situazioni di PLAGIO. Se tali situazioni si
   verificheranno *tutti* gli elaborati coinvolti verranno annullati con
   conseguente perdita del bonus. 

3) Tutti gli studenti coinvolti in un episodio di PLAGIO comprovato dovranno
   re-implementare il frammento incriminato e saranno sottoposti ad una prova
   orale supplementare. In caso di recidive verranno esclusi dalla
   possibilita' di sostenere l'esame per TUTTO IL RESTO DELL'ANNO ACCADEMICO
   IN CORSO.

4) Chi in sede di orale risulta palesemente non essere l'autore del software
   consegnato in uno dei frammenti verra' escluso dalla possibilita' di
   sostenere l'esame per TUTTO IL RESTO DELL'ANNO ACCADEMICO IN CORSO.

5) Tutti i comportamenti scorretti ai punti 3 e 4 verranno segnalati
   ufficialmente al presidente del corso di laurea, che si riserva di
   decidere azioni disciplinari supplementari a quelle sopra descritte.

----------------------------
 VALUTAZIONE DELL'ESERCIZIO:
----------------------------

Gli studenti che consegnano una versione funzionante e ragionevolmente
corretta dello script entro la data di scadenza prevista su WEB
accumulano un bonus di 2 punti che verra' sommato al voto finale (vedi
lucidi lezioni ed esercitazioni).

La qualita' del codice consegnato verra' valutata come
parte del progetto finale e contribuira' alla votazione assegnata al progetto.
Eventuali caratteristiche in piu' rispetto a quelle strettamente richieste
dalle specifiche date verranno valutate in questa sede.
